home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / dstool / readme < prev    next >
Text File  |  1994-10-23  |  8KB  |  199 lines
  1.  
  2. This file contains: 
  3.  
  4.     1.  A brief description of the dstool program for the investigation
  5.         of dynamical systems, together with warranty and copyright
  6.         information.
  7.  
  8.     2.  Instructions for obtaining a copy of the program distribution
  9.         file and documents.
  10.  
  11.         3.  Brief descriptions for printing a copy of the installation
  12.         manual and an overview of the steps required to install 
  13.         dstool on a Sun workstation.
  14.  
  15.  
  16.  
  17. I. dstool Program Description, Warranty and Copyrights
  18. ------------------------------------------------------
  19.  
  20. There is a critical need for computational environments that provide effective
  21. tools for exploring dynamical systems with minimal effort on the part of the
  22. user.  Research that relies upon the investigation of dynamical systems would
  23. be greatly enhanced by a standard, uniform environment for the exploration of
  24. these systems with computers.
  25.  
  26. The explosion of the graphical computational capabilities of relatively in-
  27. expensive desktop computers in the past few years makes the development of such
  28. an environment both feasible and timely.  The program described here, called
  29. dstool (pronounce d dee-ess-TOOL), describes an implementation of one such 
  30. environment for the Sun UNIX workstation.  It is an efficient research tool 
  31. that integrates a friendly graphical user interface, data management 
  32. capabilities, a rich set of numerical algorithms together with the  
  33. flexibility to add more algorithms and communicate data with other programs.  
  34. dstool has been implemented for use with the X Window system from MIT  
  35. and is based upon the program kaos, written by S. Kim and J. Guckenheimer.
  36.  
  37. The dstool program is the property of:
  38.  
  39.                              Cornell University 
  40.                         Center of Applied Mathematics 
  41.                               Ithaca, NY 14853
  42.  
  43. and may be used, modified and distributed freely, subject to the following
  44. restrictions:
  45.  
  46.        Any product which incorporates source code from the dstool
  47.        program or utilities, in whole or in part, is distributed
  48.        with a copy of that source code, including this notice. You
  49.        must give the recipients all the rights that you have with
  50.        respect to the use of this software. Modifications of the
  51.        software must carry prominent notices stating who changed
  52.        the files and the date of any change.
  53.  
  54. dstool is distributed in the hope that it will be useful, but WITHOUT ANY 
  55. WARRANTY; without even the implied warranty of FITNESS FOR A PARTICULAR
  56. PURPOSE.  The software is provided as is without any obligation on the part
  57. of Cornell faculty, staff or students to assist in its use, correction,
  58. modification or enhancement.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. II. Obtaining a Distribution Copy of Dstool and Documentation
  65. -------------------------------------------------------------
  66.  
  67.  
  68. There are three ways to get a distribution copy of the dstool program:  
  69.  
  70. Ethernet: The dstool distribution may be obtained from an archive server
  71.       supported by the Center for Applied Mathematics at Cornell
  72.       University.  The server network address is cam.cornell.edu
  73.       (internet address: 132.236.122.12).  Access to the server is best
  74.       accomplished using the ARPANET standard File Transfer Protocol 
  75.       (ftp), a utility which facilitates the transfer of files between
  76.       network sites.
  77.           
  78. Diskette: The dstool program and manuals can be packaged on a set of 3.5
  79.       inch diskettes which may be read on a Sun diskette drive.  In-
  80.       structions for extracting the software from the diskettes using
  81.       standard Sun operating system commands are presented in the in-
  82.       stallation manual.
  83.           
  84. Tape:     Source code and documentation are stored on a 1/4 inch distri-
  85.       bution tape using the UNIX tape  archive (tar) utility. Write to
  86.       authors enclosing a blank tape to get a distribution copy of dstool.
  87.       Instructions for reading the distribution tape are given in the in-
  88.       stallation manual.
  89.  
  90. Inquiries regarding tape and diskette distribution copies may be addressed to:
  91.  
  92.                           Attn:  Dstool Distribution  
  93.                           Center for Applied Mathematics
  94.                           Cornell University 
  95.                           305 Sage Hall 
  96.                           Ithaca, New York 14853
  97.                           
  98. The following is a brief outline of the steps required to obtain a copy of
  99. the dstool program and installation manual from the network:
  100.  
  101.    Step 1: Create a subdirectory on your workstation for the dstool program
  102.        to reside.  This file can have any name, but you must have permis-
  103.        sions for reading and writing in this subdirectory.  We shall call
  104.        the name of this subdirectory the <dstool_dir> directory in the
  105.        steps that follow.  
  106.        
  107.    Step 2: Move to the dstool home directory if you are not already in it,
  108.        by typing:
  109.  
  110.               cd <dstool_dir>
  111.  
  112.    Step 3: In order to connect to the archive server, type:
  113.  
  114.               ftp cam.cornell.edu
  115.        or
  116.           ftp 132.236.122.12
  117.  
  118.    Step 4: Follow the login process with the user name anonymous and the
  119.        password anonymous.                         ---------
  120.                     ---------
  121.  
  122.    Step 5: Once you have gained access to the system, move to the directory
  123.        pub/dstool by typing: 
  124.  
  125.           cd pub/dstool
  126.  
  127.    Step 6: Put the ftp program in 'binary' mode with the command:
  128.  
  129.           binary
  130.  
  131.    Step 7: To list the files in this directory, type ls. To get the dstool
  132.        source file, type:
  133.  
  134.               get dstool_1.1.tar
  135.  
  136.    Step 8: To obtain a complete copy of the installation manual, in 
  137.        PostScript format, type:
  138.  
  139.           get install.ps.Z
  140.  
  141.            The file is in compressed format.  Consult your system manager
  142.        concerning the steps required to print a PostScript document
  143.        from your workstation.
  144.  
  145.        Latex source for a no figures version of the documentation is
  146.        in the subdirectory Manuals_tex.
  147.  
  148.    Step 9: After the file transfer is complete, exit ftp by typing quit.
  149.                                    ----
  150.  
  151.    Step 10: Restore the file system hierarchy by typing:
  152.           tar xvf dstool_1.1.tar
  153.  
  154.    Step 11: Before you can begin the installation of dstool you must:
  155.  
  156.          1.  Set the environment variable DSTOOL to be the <dstool_dir>
  157.          directory where the program source will reside.
  158.  
  159.              2.  Check to insure the OPENWINHOME and LD_LIBRARY_PATH
  160.          environment variables are set properly for your OpenWindows
  161.          installation. Make sure $OPENWINHOME/lib is included in the 
  162.          link path ( $LD_LIBRARY_PATH ).
  163.  
  164.              3.  Start-up the OpenWindows window system, if you have not
  165.          already done so.
  166.  
  167.              4.  Move to the <dstool_dir>/bin directory.
  168.  
  169.          5.  Begin the dstool installation by executing the shellscript
  170.          install_dstool and answering the questions. 
  171.  
  172.  
  173.     -------------------------------------------------------------------------
  174.     | Note:  The installation will not succeed if the environment variables |
  175.     |     DSTOOL, OPENWINHOME and LD_LIBRARY_PATH are not set correctly.    |
  176.     |     Consult the dstool installation guide for further details.        |
  177.     -------------------------------------------------------------------------
  178.  
  179. After unpacking, a list of libraries and include files used by dstool will 
  180. be found in $DSTOOL/site_specific/DEPENDENCIES. If your xview, olgx, or 
  181. X11 files are in different places than the standard Open Windows 
  182. Distribution, this will be a useful file to check.
  183.  
  184. If you are updating from Version 1.0, we suggest you install Version 1.1
  185. in a new directory (e.g. /usr/local/dstool_1.1). Users will need to
  186. update their DSTOOL environment variable to point to this directory.
  187. They should also be told of the updating procedure described in the 
  188. file $DSTOOL/USER_UPDATING.
  189.  
  190. If you would like to be included on a dstool mailing list to receive
  191. notices about dstool updates, future releases, and bug fixes, please
  192. send your e-mail address to:
  193.  
  194.             dstool-list@cam.cornell.edu
  195.  
  196. Please address all other correspondence and bug reports to:
  197.  
  198.             dstool_bugs@cam.cornell.edu
  199.